home *** CD-ROM | disk | FTP | other *** search
/ BMUG Revelations / BMUG Revelations.toast / Utilities / Random / Commodore 64c / 0.2 - README < prev    next >
Text File  |  1994-03-21  |  6KB  |  137 lines
  1. Commodore 64 Emulator Version 0.2 Readme
  2. (C) 1993-4 Earle F. Philhower III (st916w9r@dunx1.ocs.drexel.edu)
  3.  
  4.       (Also glance over the version 0.1 readme for more information)
  5.  
  6. ************************************************************************
  7. Please use my DREXEL.EDU email address, not my ge.com one.  I will be
  8. going back to school (co-op job's over) and any mail sent to the ge.com
  9. address will be thrown down the bit bucket by the sysadmins.
  10.                          st916w9r@dunx1.ocs.drexel.edu
  11. ************************************************************************
  12.  
  13. There are now 2 (TWO) versions of the emulator: "Commodore 64" and
  14. "Commodore 64c".  "Commodore 64" is the black-and-white version that should
  15. run on any Mac w/System 7.0+ and 768K free.  "Commodore 64c" is the color
  16. version of the emulator, which will just crash any Mac w/o color QD.  You are
  17. warned!  The two versions are identical except for the video routines, so all
  18. comments apply to both versions.
  19.  
  20. Changes since v0.1:
  21.  
  22.     *************
  23.     *************
  24.     *** COLOR ***  Thanks to Eric M. Stadherr <emstadth@iastate.edu>
  25.     *************  Any comments/suggestions to Eric, as I can't even run
  26.     *************  his code on my Mac Classic I :-<
  27.    
  28.     Fixed most major keyboard bugs (I was passing a char instead of an int!)
  29.         F-Keys = OPTION-#
  30.         RUN-STOP = ESC
  31.         RUN-STOP/RESTORE = ` (back apostrophe)
  32.         semi-colon works
  33.     Floppy drive (#8) works!  Uses D64 images (from C64S on the IBM)
  34.         This means any old images (which are corrupt anyway) won't work!
  35.     Support for T64 tape images (from C64S on the IBM)
  36.     Options which are not available are disabled in the menus
  37.     PowerMac native compilation should be painless, thanks to 
  38.         Peter Creath <peterc@gnu.ai.mit.edu>
  39.     Black-and-white VIC support is now 20% faster on screen redraws,
  40.         again thanks to Peter Creath
  41.     Apple Events supported.  Double-clicking on a disk image attaches it!
  42.     RAM Image dumps are now supported from the File menu.
  43.  
  44. ----  
  45. Changes NOT made:
  46.  
  47.     The processor is still in C.  I was hoping to use TC as a macro assembler,
  48.     but it seems that I've got my work cut out for me.  Hopefully I'll find
  49.     some time to beat this program into submission.  Or if someone else has
  50.     this already done for me, give me a note!
  51.     
  52.     The Hard Drive interface is still crappy.  This isn't as big of a problem
  53.     now, since most people will be running off of D64 and T64 images.
  54.     
  55.     Tape images (T64) only support loading the first file from the image.  Not
  56.     a problem since 99.9% of T64 images are just a single file.
  57.     
  58. ----
  59. Floppy/Tape Input/Output:
  60.  
  61.     This program is child's play to run, but some information about the
  62. disk and tape formats is in order.  The "D64" disk images I mentioned above
  63. are from a C64 emulator available on the IBM called "C64S."  If you own a
  64. PC you *MUST* get this emulator, as it is one incredible piece of work.  Anyway
  65. you can find the "D64" images on a few sites now, and to use these disk images
  66. with my emulator all you have to do is select "Attach Floppy Image..." from
  67. the "Devices" menu and select the proper file.  [Tech. Note:  The D64 is just
  68. a raw sector dump starting at track 1 sector 0, spiraling in to track 35]
  69.  
  70.     The "T64" format I mentioned earlier is yet another special file for the
  71. "C64S" emulator that allow a one or two programs to be stored in a single file
  72. without the overhead of storing a complete disk image.  To use these types of
  73. files on the emulator all you have to do is select "Load Tape Image..." from
  74. the "Devices" menu.
  75.  
  76. ----
  77. Users Manual:
  78.  
  79.     There is none.  This is an 0.2 release, you silly fool!
  80.  
  81. ----
  82. Credits:
  83.  
  84.     I really should start up a list of people whose comments and snippets and
  85.     suggestions have helped make this program possible.  The next release will
  86.     definitely have this section, but as it's almost midnight and I have work
  87.     tomorrow morning...suffice it to say that the people who've contributed
  88.     know who they are...
  89.     
  90.     One person that I can't blow off, however, is one Eric M. Stadtherr
  91.     <emstadth@iastate.edu>.  He is the only person who has delivered color
  92.     code for the emulator, so all praise/flames go to him.  (Only for the
  93.     video portion.  If you have a problem w/something other than the color
  94.     display part of the program yell at me.   Well, don't yell...)
  95.  
  96. ----
  97. How You Can Help:
  98.  
  99.     I have the documentation on the undocumented opcodes, but haven't sat
  100. down and written the code to implement these...hint hint.
  101.  
  102.     If anyone has the control codes for the MPS801 printer, I'd be interested
  103. in hearing from you.  If I get the printer support working (not hard, but low
  104. on list of priorities) I would like to support graphics modes but no longer
  105. have my printer manual [or printer].
  106.  
  107.     Send any comments, suggestions, bug(!) reports to my email address at
  108. Drexel University:  st916w9r@dunx1.ocs.drexel.edu.  In your first message I'd
  109. also like to know where you heard about the emulator and from where you
  110. downloaded it, for my own information.
  111.  
  112. ------------
  113. "Commodore 64 Emulator...
  114. It's not much, but it's the *only* Commodore 64 you can run on your Mac!"
  115.  
  116. Any user suggestions, bug-fixes, updates please email to the above address
  117. (st916w9r@dunx1.ocs.drexel.edu).  I'm especially interested in any 68000
  118. based 6510 simulators.  The current code was written for portability
  119. (It took me all of 15 mins to get this code running on my 486 Linux box!),
  120. not breakneck speed.
  121.  
  122.     This program is free software; you can redistribute it and/or modify
  123.     it under the terms of the GNU General Public License as published by
  124.     the Free Software Foundation; either version 2 of the License, or
  125.     (at your option) any later version.
  126.  
  127.     This program is distributed in the hope that it will be useful,
  128.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  129.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  130.     GNU General Public License for more details.
  131.  
  132.     You should have received a copy of the GNU General Public License
  133.     along with this program; if not, write to the Free Software
  134.     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  135.  
  136. (C) 1993-4 Earle F. Philhower III (st916w9r@dunx1.ocs.drexel.edu)
  137.